home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 15 / CU Amiga Magazine's Super CD-ROM 15 (1997)(EMAP Images)(GB)[!][issue 1997-10].iso / CUCD / Graphics / Ghostscript / source / iname.h < prev    next >
C/C++ Source or Header  |  1995-06-26  |  4KB  |  101 lines
  1. /* Copyright (C) 1989, 1995 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17. */
  18.  
  19. /* iname.h */
  20. /* Name table interface */
  21.  
  22. /*
  23.  * This file defines those parts of the name table API that do not depend
  24.  * at all on the implementation.
  25.  */
  26.  
  27. /* ---------------- Abstract types ---------------- */
  28.  
  29. typedef struct name_table_s name_table;
  30.  
  31. /* ---------------- Constant values ---------------- */
  32.  
  33. extern const uint name_max_string;
  34.  
  35. /* ---------------- Procedural interface ---------------- */
  36.  
  37. /* Allocate and initialize a name table. */
  38. name_table *name_init(P2(ulong, gs_memory_t *));
  39.  
  40. /*
  41.  * The name table machinery is designed so that multiple name tables
  42.  * are possible, but the interpreter relies on there being only one,
  43.  * and many of the procedures below assume this (by virtue of
  44.  * not taking a name_table argument).  Therefore, we provide a procedure
  45.  * to get our hands on that unique table (read-only, however).
  46.  */
  47. const name_table *the_name_table(P0());
  48.  
  49. /* Get the allocator for the name table. */
  50. gs_memory_t *name_memory(P0());
  51.  
  52. /*
  53.  * Look up and/or enter a name in the name table.
  54.  * The values of enterflag are:
  55.  *    -1 -- don't enter (return an error) if missing;
  56.  *     0 -- enter if missing, don't copy the string, which was allocated
  57.  *        statically;
  58.  *     1 -- enter if missing, copy the string;
  59.  *     2 -- enter if missing, don't copy the string, which was already
  60.  *        allocated dynamically (using the name_memory allocator).
  61.  * Possible errors: VMerror, limitcheck (if string is too long or if
  62.  * we have assigned all possible name indices).
  63.  */
  64. int name_ref(P4(const byte *ptr, uint size, ref *pnref, int enterflag));
  65. void name_string_ref(P2(const ref *pnref, ref *psref));
  66. /*
  67.  * name_enter_string calls name_ref with a (permanent) C string.
  68.  */
  69. int name_enter_string(P2(const char *str, ref *pnref));
  70. /*
  71.  * name_from_string essentially implements cvn.
  72.  * It always enters the name, and copies the executable attribute.
  73.  */
  74. int name_from_string(P2(const ref *psref, ref *pnref));
  75.  
  76. /* Compare two names for equality. */
  77. #define name_eq(pnref1, pnref2)\
  78.   ((pnref1)->value.pname == (pnref2)->value.pname)
  79.  
  80. /* Invalidate the value cache for a name. */
  81. void name_invalidate_value_cache(P1(const ref *));
  82.  
  83. /* Convert between names and indices. */
  84. uint name_index(P1(const ref *));        /* ref => index */
  85. name *name_index_ptr(P1(uint nidx));        /* index => name */
  86. void name_index_ref(P2(uint nidx, ref *pnref));    /* index => ref */
  87.  
  88. /* Get the index of the next valid name. */
  89. /* The argument is 0 or a valid index. */
  90. /* Return 0 if there are no more. */
  91. uint name_next_valid_index(P1(uint));
  92.  
  93. /* Mark a name for the garbage collector. */
  94. /* Return true if this is a new mark. */
  95. bool name_mark_index(P1(uint));
  96.  
  97. /* Get the object (sub-table) containing a name. */
  98. /* The garbage collector needs this so it can relocate pointers to names. */
  99. void/*obj_header_t*/ *name_ref_sub_table(P1(const ref *));
  100. void/*obj_header_t*/ *name_index_ptr_sub_table(P2(uint, name *));
  101.